package com.shop.zkmall.app.service.a;

import com.baomidou.mybatisplus.extension.service.IService;
import com.shop.zkmall.app.domain.CereBuyerLiveRoom;
import com.shop.zkmall.app.domain.req.*;
import com.shop.zkmall.app.domain.res.RecommendRes;
import com.shop.zkmall.commons.domain.buyer.CereBuyerUser;
import com.shop.zkmall.commons.domain.common.PageParam;
import com.shop.zkmall.commons.result.R;

import java.util.List;

/**
 * <p>
 * 直播间信息表 服务类
 * </p>
 *
 * @author ${author}
 * @since 2025-11-25
 */
public interface ICereBuyerLiveRoomService extends IService<CereBuyerLiveRoom> {

    /**
     * 直播间列表
     * @return
     */
    List<RecommendRes> recommendList(PageParam param);

    /**
     * 关注列表
     * @return
     */
    List<RecommendRes> attentionList(PageParam param, CereBuyerUser user);


    /**
     * 分类列表
     * @return
     */
    List<RecommendRes> categoryList(LiveCateGoryReq param, CereBuyerUser user);

    /**
     * 搜索列表
     * @return
     */
    List<RecommendRes> searchLiveList(LiveSearchReq param, CereBuyerUser user);

    /**
     * 保存直播间信息
     * @return
     */
    R<?> saveLiveSetting(CereBuyerLiveRoomReq cereBuyerLiveRoomReq);

    /**
     * 开始直播
     * @return
     */
    R<?> startLive(StartLiveReq startLiveReq);

    /**
     * 获取播放地址
     * @return
     */
    R<?> getPlayUrl(Long roomId);

    /**
     * 赠送礼物
     * @return
     */
    R<?> sendGift(SendGiftReq sendGiftReq);

    /**
     * 搜索直播商品
     * @return
     */
    R<?> searchLiveProduct(String keyWord);

    /**
     * 直播商品详情
     * @return
     */
    R<?> explainProduct(ExplainProductReq explainProductReq);

    /**
     * 加入直播间
     * @return
     */
    R<?> joinLiveRoom(JoinLiveRoomReq joinLiveRoomReq);

    /**
     * 直播间竞拍
     * @return
     */
    R<?> liveAuctionSendPrice(LiveAuctionSendPriceReq liveAuctionSendPriceReq);

    /**
     * 拍品抢购
     * @return
     */
    R<?> snapProduct(SnapProductReq snapProductReq);
}
